/Services/GetLink (Method)

Description

Get a link to a specific page as a specific user.

Request (GetLinkSoapIn)

The request body is of type GetLink.

Request Body Parameters

Name	Description	Data Type
p_APICode	The API code of the site. This can be found through your Sertifi web interface under Administration -> Account Settings.	xml:string
parameters	An array of link parameters to for the desired links.	ArrayOfLinkParameter

Response (GetLinkSoapOut)

The response body is of type GetLinkResponse.

Response Body Parameters

Name	Description	Data Type
GetLinkResult	List of links or error message.	ArrayOfUrlQueryResult

Example

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ser="http://apps.sertifi.net/services/" xmlns:lin="https://apps.sertifi.net/services/LinkParameter">
   <soap:Header/>
   <soap:Body>
      <ser:GetLink>
         <ser:p_APICode>88F54943-115A-4BD7-B325-52262BCA2F98</ser:p_APICode>
         <ser:parameters>
            
            <ser:LinkParameter>
               
               <lin:FileId>d4pA7tZhuGA=</lin:FileId>
               
               <lin:DocumentId>vqUbZIRdBq4=</lin:DocumentId>
               
               <lin:PaymentId>Ubq4ZvqIRdB=</lin:PaymentId>
               <lin:LinkType>PrintablePdfLink</lin:LinkType>
               
               <lin:SignerEmail>[email protected]</lin:SignerEmail>
            </ser:LinkParameter>
         </ser:parameters>
      </ser:GetLink>
   </soap:Body>
</soap:Envelope>

Remarks

Link types:
DocumentEditLocationsLink - Return link to edit document locations page only if document belongs to given room and is not signed
DocumentOriginalLink - Return link to original document only if document belongs to given room and its not expired
DocumentSignedLink - Return link to signed document only if document belongs to given room and is totally signed
DocumentPartiallySignedLink - Return link to partially signed document link if document belongs to given room and is partially signed
DocumentPrefillLink - Return link to edit document prefill page only if document belongs to given room and is not signed
DocumentPropertiesLink - Return link to the document management page only if document belongs to given room
FileMaintenanceLink - Return link to file maintenance page
FileSigningPageLink - Return link to file page containing list of links to sign for given user and his sequence
SigningPageLink - Return link to document signing page if the document belongs to the file and is ready to be signed by the signer
SecureSendingPageLink - Return a link to the sending page if the user is allowed to send files/documents on this site
SecureFileMaintenanceLink - Return link to file maintenance page
SecureFileSigningPageLink - Return link to file page containing list of links to sign for given user and his sequence
SecureDocumentOriginalLink - Return link to original document only if document belongs to given room and its not expired
SecureDocumentSignedLink - Return link to signed document only if document belongs to given room and is totally signed
SecureHomePageLink - Return a link to the user's home page on this site
SecureDocumentPrefillLink - Return link to edit document prefill page only if document belongs to given room and is not signed
SecureDocumentPartiallySignedLink - Return link to partially signed document link if document belongs to given room and is partially signed
PrintablePdfLink - Return a link to the printable version of the document
PaymentReceiptLink - Return a link to the receipt page for the payment id passed in.
SecurePaymentLink - Return a link to a secure version of PaymentReceiptLink for emails etc.

Common Errors include:
"ERROR: Invalid API Code"
"File could not be accessed."
"Document could not be accessed."
"Document is expired."
"Signer email is invalid. "
"Signer is not a part of the file."
"... is not an allowed sender for this account."
"... is not allowed to make changes to this folder."
"Form is deleted or not yet created, please try different document."
"Document Prefill link is not available for this document."